Airtable Interface gap analysis: UI protocol evaluation & roadmap by Copilot · Pull Request #695 · objectstack-ai/framework

Copilot · 2026-02-16T03:10:52Z

Evaluates ObjectStack's UI Protocol against Airtable Interfaces to identify gaps and propose schema improvements. ObjectStack already exceeds Airtable in raw component capabilities (45+ chart types, Gantt/Map views, offline support, AI components, theming) but lacks the composition layer — the "Interface" abstraction that bundles pages into shareable, role-specific surfaces.

New: `docs/design/airtable-interface-gap-analysis.md`

Feature comparison matrix — 50+ features across 5 categories (page types, views, elements, permissions, sharing)
9 gaps identified, prioritized P0–P2:
- P0: No first-class InterfaceSchema, no Record Review page type, no standalone content elements (text/number/image/divider)
- P1: No sharing/embedding config, no per-element data binding, no inline form element
- P2: No user impersonation preview, no interface templates, no record picker element
17 ObjectStack advantages documented (multi-level grouping, 6 form types, DnD protocol, i18n, responsive, animation, etc.)
5 schema proposals with Zod code examples:

// Proposed InterfaceSchema — self-contained shareable surface
export const InterfaceSchema = z.object({
  name: z.string().regex(/^[a-z_][a-z0-9_]*$/),
  label: z.string(),
  pages: z.array(InterfacePageSchema),
  sharing: SharingConfigSchema.optional(),
  assignedRoles: z.array(z.string()).optional(),
});

4-phase implementation roadmap: Phase A (v3.2) → Phase D (v4.1)
Risk analysis and decision log

Modified: `ROADMAP.md`

Added §8.1 UI Protocol Enhancement with phased deliverables (A–D)
Updated versioning plan (v3.2–v4.1) to include UI protocol milestones
Added Interface Builder to Studio IDE section
Cross-linked design document in Related Documents

Original prompt

评估目前的UI协议和 airtable interfaces的差距，如何实现类似Airtable的所有界面自定义功能，编写详细的对比与改进评估，文档更新Road Map

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

vercel · 2026-02-16T03:10:57Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
objectstack-play	Ready	Preview, Comment	Feb 16, 2026 3:32am
spec	Ready	Preview, Comment	Feb 16, 2026 3:32am

- Create docs/design/airtable-interface-gap-analysis.md with detailed comparison of ObjectStack UI Protocol vs Airtable Interfaces - Add UI Protocol Enhancement roadmap items to Phase 8 (8.1) - Update versioning plan with UI protocol work in v3.2-v4.1 - Add design document reference to Related Documents section Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Copilot

Pull request overview

This PR adds a comprehensive design document evaluating ObjectStack's UI Protocol against Airtable Interfaces, identifying capability gaps and proposing schema enhancements to achieve feature parity. The document highlights that ObjectStack already exceeds Airtable in component capabilities but lacks the "Interface" abstraction layer for composing shareable, role-specific application surfaces.

Changes:

Added detailed gap analysis document comparing 50+ features across page types, views, elements, permissions, and sharing capabilities
Proposed 5 new Zod schemas (InterfaceSchema, RecordReviewConfigSchema, element prop schemas, sharing schemas) with implementation roadmap
Updated ROADMAP.md with 4-phase UI Protocol Enhancement plan (v3.2-v4.1) and cross-referenced the new design document

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File	Description
docs/design/airtable-interface-gap-analysis.md	New comprehensive design document with feature comparison matrix, gap analysis (9 gaps P0-P2), 17 ObjectStack advantages, schema proposals, 4-phase roadmap, risk analysis, and decision log
ROADMAP.md	Added §8.1 UI Protocol Enhancement section with phased deliverables (A-D), updated versioning plan (v3.2-v4.1) to include UI protocol milestones, added Interface Builder to Studio IDE section, and cross-linked design document

Copilot · 2026-02-16T04:14:18Z

+  placeholder: z.string().optional(),
+  variable: z.string().describe('Page variable to bind selected record ID'),


The placeholder property in ElementRecordPickerPropsSchema is missing a .describe() annotation. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

Copilot · 2026-02-16T04:14:18Z

+  submitLabel: z.string().optional().default('Submit'),
+  successMessage: z.string().optional(),
+  resetAfterSubmit: z.boolean().optional().default(true),
+});


The submitLabel, successMessage, and resetAfterSubmit properties in ElementFormPropsSchema are missing .describe() annotations. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

Copilot · 2026-02-16T04:14:19Z

+  sort: z.array(SortItemSchema).optional(),
+  limit: z.number().optional().describe('Max records to display'),


The sort property in ElementDataSourceSchema is missing a .describe() annotation. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

Copilot · 2026-02-16T04:14:19Z

+
+export const InterfaceSchema = z.object({
+  name: z.string().regex(/^[a-z_][a-z0-9_]*$/)


The proposed InterfaceSchema.name field uses the regex /^[a-z_][a-z0-9_]*$/ which allows names to start with an underscore. This is inconsistent with the existing SnakeCaseIdentifierSchema convention (packages/spec/src/shared/identifiers.zod.ts), which requires identifiers to start with a lowercase letter: /^[a-z][a-z0-9_]*$/.

The schema should use SnakeCaseIdentifierSchema directly instead of a custom regex, or if a custom regex is needed, it should match the established pattern of starting with a letter.

Suggested change

export const InterfaceSchema = z.object({

name: z.string().regex(/^[a-z_][a-z0-9_]*$/)

import { SnakeCaseIdentifierSchema } from '../shared/identifiers.zod';

export const InterfaceSchema = z.object({

name: SnakeCaseIdentifierSchema

Copilot · 2026-02-16T04:14:19Z

+  variant: z.enum(['heading', 'subheading', 'body', 'caption'])
+    .optional().default('body'),
+  align: z.enum(['left', 'center', 'right']).optional().default('left'),
+});


The variant and align properties in ElementTextPropsSchema are missing .describe() annotations. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

All properties should have descriptive .describe() calls, for example:

variant should have .describe('Text variant style')

align should have .describe('Text alignment')

Copilot · 2026-02-16T04:14:19Z

+  format: z.enum(['number', 'currency', 'percent']).optional(),
+  prefix: z.string().optional(),
+  suffix: z.string().optional(),
+});


The format, prefix, and suffix properties in ElementNumberPropsSchema are missing .describe() annotations. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

All properties should have descriptive .describe() calls.

Copilot · 2026-02-16T04:14:19Z

+  fit: z.enum(['cover', 'contain', 'fill']).optional().default('cover'),
+  height: z.number().optional().describe('Fixed height in pixels'),


The fit property in ElementImagePropsSchema is missing a .describe() annotation. According to the codebase convention (guideline 1000000: "Zod First"), ALL Zod schema fields must include .describe() annotations for documentation and JSON Schema generation.

Initial plan

2c0151e

Copilot AI assigned Copilot and hotlong Feb 16, 2026

Copilot started work on behalf of hotlong February 16, 2026 03:11 View session

Copilot AI changed the title ~~[WIP] Assess UI protocols against Airtable interfaces~~ Airtable Interface gap analysis: UI protocol evaluation & roadmap Feb 16, 2026

Copilot AI requested a review from hotlong February 16, 2026 03:21

Copilot finished work on behalf of hotlong February 16, 2026 03:21

vercel Bot deployed to Preview – spec February 16, 2026 03:31 View deployment

vercel Bot deployed to Preview – objectstack-play February 16, 2026 03:32 View deployment

hotlong marked this pull request as ready for review February 16, 2026 04:09

Copilot AI review requested due to automatic review settings February 16, 2026 04:09

hotlong merged commit 6a010eb into main Feb 16, 2026
3 checks passed

Copilot started reviewing on behalf of hotlong February 16, 2026 04:09 View session

Copilot AI reviewed Feb 16, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Airtable Interface gap analysis: UI protocol evaluation & roadmap#695

Airtable Interface gap analysis: UI protocol evaluation & roadmap#695
hotlong merged 2 commits intomainfrom
copilot/evaluate-ui-protocols

Copilot AI commented Feb 16, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Feb 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Copilot AI Feb 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		placeholder: z.string().optional(),
		variable: z.string().describe('Page variable to bind selected record ID'),

		sort: z.array(SortItemSchema).optional(),
		limit: z.number().optional().describe('Max records to display'),


		export const InterfaceSchema = z.object({
		name: z.string().regex(/^[a-z_][a-z0-9_]*$/)

		fit: z.enum(['cover', 'contain', 'fill']).optional().default('cover'),
		height: z.number().optional().describe('Fixed height in pixels'),

Conversation

Copilot AI commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New: docs/design/airtable-interface-gap-analysis.md

Modified: ROADMAP.md

Uh oh!

vercel Bot commented Feb 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Feb 16, 2026 •

edited

Loading

New: `docs/design/airtable-interface-gap-analysis.md`

Modified: `ROADMAP.md`

vercel Bot commented Feb 16, 2026 •

edited

Loading